<html lang="en-US">

<head>
    
<title>学会使用 GDB 调试 Go 代码 - 花落雨忧</title>

<meta property="og:title" content="学会使用 GDB 调试 Go 代码 - 花落雨忧">



    



    
    <meta property="description" content="大家好，我是煎鱼。
上一篇文章《一个 Demo 学会使用 Go Delve 调试》我们详细介绍了 Go 语言如何使用 Delve 进行排查和调试，对于问题的解决非常的有帮助。
但调试工具肯定不止只有 Delve，今天我们来介绍第二个神器，那就是：GDB。
[&amp;hellip;] GDB 是一个类 UNIX 系统下的程序调试工具，允许你看到另一个程序在执行时 &amp;ldquo;内部 &amp;ldquo;发生了什 &amp;hellip;">
    <meta property="og:description" content="大家好，我是煎鱼。
上一篇文章《一个 Demo 学会使用 Go Delve 调试》我们详细介绍了 Go 语言如何使用 Delve 进行排查和调试，对于问题的解决非常的有帮助。
但调试工具肯定不止只有 Delve，今天我们来介绍第二个神器，那就是：GDB。
[&amp;hellip;] GDB 是一个类 UNIX 系统下的程序调试工具，允许你看到另一个程序在执行时 &amp;ldquo;内部 &amp;ldquo;发生了什 &amp;hellip;">
    






<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1">

<link rel="shortcut icon" href="https://www.lican.site/logo/logo.png" type="image/x-icon" />



<link rel="stylesheet" href="/css/style.min.css" />

<link rel="stylesheet" href="/css/reset.min.css" />




<script src="https://www.lican.site/js/highlight.min.js"></script>

<script>
hljs.configure({ ignoreUnescapedHTML: true })
hljs.highlightAll();
</script>


<script src="https://www.lican.site/js/jquery.min.js"></script>




<link href="https://www.lican.site/css/hugo-code.min.css" rel="stylesheet" />



    <style>
        .post-content img {
            max-width: 400px;
        }
    </style>
</head>

<body id="period" class="home blog">
    <a class="skip-content" href="#main">Press "Enter" to skip to content</a>
    <div id="overflow-container" class="overflow-container">
        <header class="site-header" id="site-header" role="banner">
    <div class="max-width">
        <div id="title-container" class="title-container">
            <div id="site-title" class="site-title"><a href="/">花落雨忧</a></div>
            <p class="tagline">思所及 力所行 方为真.</p>
        </div>
        
        <div id="menu-primary-container" class="menu-primary-container">
            <div class="icon-container">
            </div>
            <div id="menu-primary" class="menu-container menu-primary" role="navigation">
                <nav class="menu">
                    <ul id="menu-primary-items" class="menu-primary-items">
                        
                        
                        <li id="menu-item-0"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/posts" aria-current="page" tabindex="0">首页</a></li>
                        
                        <li id="menu-item-1"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/tech/" aria-current="page" tabindex="1">技术文档</a></li>
                        
                        <li id="menu-item-2"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/article/" aria-current="page" tabindex="2">文章</a></li>
                        
                        <li id="menu-item-3"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/project/" aria-current="page" tabindex="3">项目</a></li>
                        
                        <li id="menu-item-4"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/about/" aria-current="page" tabindex="4">关于</a></li>
                        
                    </ul>
                </nav>
            </div>
        </div>
    </div>
</header>
        <div id="primary-container" class="primary-container">
            <div class="max-width">
                <section id="main" class="main" role="main">
                    <div id="loop-container" class="loop-container">
                        <div
                            class="post type-post status-publish format-standard hentry entry">
                            <article>
                                <div class="post-container">
                                    <div class="post-header">
                                        <h2 class="post-title">
                                            <a href="/posts/go/gdb/">学会使用 GDB 调试 Go 代码</a>
                                        </h2>
                                        
                                        <div class="post-byline">Published on
                                            <a class="date" href="javascript:;">2021/12/31</a>
                                            
                                            
                                            
                                            
                                            
                                        
                                    </div>
                                    <div class="post-content">
                                        <p>大家好，我是煎鱼。</p>
<p>上一篇文章《一个 Demo 学会使用 Go Delve 调试》我们详细介绍了 Go 语言如何使用 Delve 进行排查和调试，对于问题的解决非常的有帮助。</p>
<p>但调试工具肯定不止只有 Delve，今天我们来介绍第二个神器，那就是：GDB。</p>
<h2 id="gdb-是什么">GDB 是什么</h2>
<p>GDB 是一个类 UNIX 系统下的程序调试工具，允许你看到另一个程序在执行时 &ldquo;内部 &ldquo;发生了什么，或者程序在崩溃时正在做什么。</p>
<p><img src="https://files.mdnice.com/user/3610/35fc6475-ec0d-44a0-ae8c-920121130edb.png" alt="GDB Logo"></p>
<p>主要可以做四类事情：</p>
<ol>
<li>启动你的程序，指定任何可能影响其行为的东西。</li>
<li>使你的程序在指定的条件下停止。</li>
<li>检查当你的程序停止时发生了什么。</li>
<li>改变你程序中的东西，这样你就可以试验纠正一个错误的影响，并继续了解另一个错误。</li>
</ol>
<h2 id="安装">安装</h2>
<p>如果是在 MacOS 上的话，可以直接使用 brew 安装：</p>
<pre><code>brew install gdb
</code></pre><p>如果是在 Linux ，则使用自带的包管理工具进行安装即可，但需要注意安装完毕后需要在 HOME 目录进行相关配置。</p>
<p>安装完毕后，执行 <code>gdb</code> 就可以看到：</p>
<pre><code>$ gdb
GNU gdb (GDB) 10.2
...
(gdb) 
</code></pre><p>写此文时最新的 gdb 版本已经是 10.2 了，我也升级了上去。问题不大，还多了不少功能。</p>
<h2 id="编译">编译</h2>
<p>我们还是使用先前的演示程序来进行调试。但由于 Go 语言的不少编译优化，因此在编译运行程序时，有以下几点需要注意：</p>
<ul>
<li>
<p>go build 编译时需要增加 <code>-gcflags=all=&quot;-N -l&quot;</code> 指令来关闭内联优化，方便接下来的调试。</p>
</li>
<li>
<p>若是 MacOS，在 go build 编译时需要增加 <code>-ldflags='-compressdwarf=false'</code> 指令。</p>
<ul>
<li>若不禁止，则会出现 <code>No symbol table is loaded. Use the &quot;file&quot; command.</code> 的错误。</li>
<li>Go 编译默认为了减少二进制大小会默认压缩 DWARF 调试信息，但这会影响 gdb 的调试，因此需要将其关闭。</li>
</ul>
</li>
</ul>
<p>编译的命令是：</p>
<pre><code>$ go build -gcflags=all=&quot;-N -l&quot; -ldflags='-compressdwarf=false' .
</code></pre><p>输出结果：</p>
<pre><code>！了鱼煎进子脑
</code></pre><h2 id="尝试-gdb">尝试 gdb</h2>
<p>GDB 有两种调试模式，分别是文本用户界面（Text User Interface，简称 tui）和默认的命令行模式：</p>
<pre><code>// 调试界面
$ gdb -tui ./awesome-project

// 命令行模式
$ gdb ./awesome-project
</code></pre><p>接下来我们使用 gdb tui 的调试模式来给大家演示功能。</p>
<p>我们在执行命令 <code>gdb -tui ./awesome-project</code> 后，窗口会切换为如下：</p>
<p><img src="https://files.mdnice.com/user/3610/2a7096f4-addd-404f-9a47-4a97cbe9d595.png" alt="gdb tui 初始样子"></p>
<p>你会发现中间提示 “No Source Available”，此时你需要继续回车两次，他就会自动加载插件支持，提示：“Loading Go Runtime support.”。</p>
<p>我们就可以看到具体的代码块内容，如下：</p>
<p><img src="https://files.mdnice.com/user/3610/351571a3-b89e-42f2-941e-24e734bfae26.png" alt=""></p>
<p>用 MacOS 的同学需要注意，如果你在断点时发现发现了如下错误：</p>
<pre><code>(gdb) b main.main
Breakpoint 1 at 0x10a2ea0: file /Users/eddycjy/go-application/awesomeProject/main.go, line 15.
(gdb) r
Starting program: /Users/eddycjy/go-application/awesomeProject/hello
Unable to find Mach task port for process-id 64212: (os/kern) failure (0x5).
 (please check gdb is codesigned - see taskgated(8))
</code></pre><p>也就是 “please check gdb is codesigned - see taskgated(8)”，则需要重新处理证书认证和授权，是 MacOS 使用上的一个问题，具体可参考：《<a href="https://gist.github.com/hlissner/898b7dfc0a3b63824a70e15cd0180154">Codesign gdb on OSX</a>》。</p>
<p>解决后，咱们的 gdb 就算是能够正确的运行起来了！</p>
<h2 id="常用-gdb-命令">常用 gdb 命令</h2>
<p>在 gdb 中，和 dlv 一样有常用的关键字命令。当然了，gdb 的 help all 输出非常多：</p>
<pre><code>(gdb) help all

Command class: aliases
Command class: breakpoints

awatch -- Set a watchpoint for an expression.
break, brea, bre, br, b -- Set breakpoint at specified location.
break-range -- Set a breakpoint for an address range.
catch -- Set catchpoints to catch events.
...
</code></pre><p>常用的关键字如下：</p>
<ul>
<li>b：break 的缩写，作用是打断点，例如：main.main，可带代码行数。</li>
<li>r：run 的缩写，作用是运行程序到下一个断点处。</li>
<li>c：continue 的缩写，作用是继续执行到下一个断点。</li>
<li>s：step 的缩写，作用是单步执行，如果有所调用的方法，将会进入该方法。</li>
<li>l：list 的缩写，作用是查看对应的源码。</li>
<li>n：next 的缩写，作用是单步执行，不会进入所调用的方法，。</li>
<li>q：quit 的缩写，作用是退出。</li>
<li>info breakpoints：作用是查看所有设置的断点信息。</li>
<li>info locals：作用是查看变量信息。</li>
<li>info args：作用是查看函数的入参和出参的具体值。</li>
<li>info goroutines：作用是查看 goroutines 的信息。</li>
<li>goroutine 1 bt：作用是查看指定序号的 goroutine 调用堆栈。</li>
</ul>
<h2 id="进行调试">进行调试</h2>
<p>在调试上与 dlv 差不多，也是先执行关键字 <code>b</code> 打断点：</p>
<pre><code>(gdb) b main.main
Breakpoint 1 at 0x10cbaa0: file /Users/eddycjy/go-application/awesomeProject/main.go, line 9.
</code></pre><p>也可以先执行关键字 <code>l</code> 查看对应的代码情况再进行做决定：</p>
<pre><code>(gdb) l main.main
4		&quot;fmt&quot;
5	
6		&quot;github.com/eddycjy/awesome-project/stringer&quot;
7	)
8	
9	func main() {
10		fmt.Println(stringer.Reverse(&quot;脑子进煎鱼了！&quot;))
11	}
</code></pre><p>查看对应 goroutines 正在运行的函数情况：</p>
<pre><code>(gdb) info goroutines
  1  waiting runtime.gosched
* 13  running runtime.goexit
</code></pre><p>根据 pprof 等所得到的 goroutine 序号进行进一步的分析：</p>
<pre><code>(gdb) goroutine 1 bt
#0  0x000000000040facb in runtime.gosched () at /home/user/go/src/runtime/proc.c:873
#1  0x00000000004031c9 in runtime.chanrecv (c=void, ep=void, selected=void, received=void)
 at  /home/user/go/src/runtime/chan.c:342
#2  0x0000000000403299 in runtime.chanrecv1 (t=void, c=void) at/home/user/go/src/runtime/chan.c:423
#3  0x000000000043075b in testing.RunTests (matchString...
</code></pre><p>注意一个细节，gdb 调试是可以看到并对 runtime 包内容的代码进行断点和分析的。</p>
<p>也可以和 dlv 一样执行 p 关键字输出相应的值的类型、值内容：</p>
<pre><code>(gdb) p re
(gdb) p t
$1 = (struct testing.T *) 0xf840688b60
(gdb) p t
$1 = (struct testing.T *) 0xf840688b60
(gdb) p *t
$2 = {errors = &quot;&quot;, failed = false, ch = 0xf8406f5690}
(gdb) p *t-&gt;ch
$3 = struct hchan&lt;*testing.T&gt;
</code></pre><p>与 dlv 大同小异。</p>
<h2 id="总结">总结</h2>
<p>总体上来讲，MacOS 上使用 gdb 还是挺麻烦的，在 Linux 环境下使用 gdb 还是更方便些。</p>
<p>由于 <strong>dlv 和 gdb 在大致的调试上不会差距的太远</strong>，因此本文就没有过于展开。</p>
<p>若是对业务代码进行分析，更建议使用 dlv，也就是我们上一篇文章所讲的内容。<strong>若有 runtime 库的调试需求的话，推荐使用 gdb 来作为首要调试工具</strong>，若无这方面诉求，建议使用 dlv。</p>


                                        
                                        
                                        
                                        <div class="rp4wp-related-posts">
                                            <h3>相关文章</h3>
                                            <ul>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/news-slices-maps/">Go 提案：增加泛型版 slices 和 maps 新包</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/delve/">一个 Demo 学会使用 Go Delve 调试</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/117-build/">时隔 3 年，Go1.17 增强构建约束！</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/memory-model/">Go 内存模型：happens-before 原则</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/real-context/">分享 Go 使用 Context 的正式姿势</a>
                                                    </div>
                                                </li>
                                                
                                            </ul>
                                        </div>
                                        
                                        
                                    </div>

                                    
                                    
                                    

                                    
                                    <div class="post-meta">
                                        
                                        
                                        <div class="post-tags">
                                            <ul>
                                            
                                            <li>
                                                <a href="/tags/go" title="View all posts tagged match">go</a>
                                            </li>
                                            
                                            </ul>
                                        </div>
                                        
                                        
                                        <nav class="further-reading">
                                            
                                            <div class="previous">
                                                <span>&lt;&lt; Prev</span>
                                                <a href="https://www.lican.site/posts/2021giac/"
                                                    rel="prev">我周末参加了个架构师大会！</a> </div>
                                            
                                            
                                            <div class="next">
                                                <span>Next >></span>
                                                <a href="https://www.lican.site/posts/go/delve/">一个 Demo 学会使用 Go Delve 调试</a> 
                                            </div>
                                            
                                        </nav>
                                    </div>
                                    
                                    

                                    
                                    
                                    

                                </div>
                            </article>
                        </div>
                    </div>
                </section>
                <aside class="sidebar sidebar-primary" id="sidebar-primary" role="complementary">
    <h1 class="screen-reader-text">Sidebar</h1>
    

    
    
    <section id="text-2" class="widget widget_text">
        <div class="textwidget">
            
            <div id="profile">
                <div id="profile_picture"><img src="https://www.lican.site/logo/logo.png"></div>
                <div id="profile_intro">
                    <p><span class="name">Lican</span></p>
                    <p class="intro">全栈开发者，爱好造轮子。</p>
                </div>
            </div>
            
            <p>
                <script type="text/javascript">
                    (function ($) {
                        $(document).ready(function () {
                            var menuPrimaryContainer = $('#menu-primary-container');
                            var profile = $('#text-2');
                            $('#toggle-navigation').click(function () {
                                if (menuPrimaryContainer.hasClass('open')) {
                                    profile.removeClass('open');
                                } else {
                                    profile.addClass('open');
                                }
                            });
                        });
                    })(jQuery);
                </script>
            </p>
        </div>
    </section>
    
    
    
    
    
    <section id="text-5" class="widget widget_text">
        <h2 class="widget-title">开源项目</h2>
        <div class="textwidget">
            <div id="projects" style="line-height: 22px;">
                
                <a href="https://github.com/idoubi/gonews"
                    target="_blank">gonews</a>: &nbsp;Daily news for golang<br>
                
                <a href="https://github.com/idoubi/sql2struct"
                    target="_blank">sql2struct</a>: &nbsp;Generate go struct according to SQL<br>
                
                <a href="https://github.com/idoubi/goz"
                    target="_blank">goz</a>: &nbsp;Request library used in golang<br>
                
        </div>
    </section>
    
    

    
    
    
    
    

    
    
    

    
    
    

    
    
    
    
</aside>
            </div>
        </div>

        <footer id="site-footer" class="site-footer" role="contentinfo">
    <div class="max-width">
    </div>
    <div class="footer">
        <div id="footercontent">
            © lican.vip All rights reserved<br/>
            Built with Hugo Theme <a href="https://github.com/idoubi/hugo-theme-period" target="_blank">Period</a>
        </div>
    </div>
</footer>

<script>
    var _hmt = _hmt || [];
    (function() {
      var hm = document.createElement("script");
      hm.src = "https://hm.baidu.com/hm.js?e8351b6d4626d5881d439ea1f6184baa";
      var s = document.getElementsByTagName("script")[0]; 
      s.parentNode.insertBefore(hm, s);
    })();
</script>
    
    
    </div>
    
</body>

</html>